5.1.1 创建提款数字币至任意钱包

#简要描述：将数字币提现到钱包的提现业务接口，让用户能够将 usdt 转移到指定的钱包地址（市场汇率）

请求方式: POST
请求接口: https://网关域名/wallet-trade-merchant/v1/pay/blockchain/create
请求媒体类型( JSON 数据格式 )Content-Type: application/json

请求参数

参数名称	类型	必填	参数含义	参数说明
key	string	是	商户 key	apiKey
localOrderId	string	是	商户平台本地订单号	商户平台本地生成唯一订单号
localUserId	string	否	商户平台本地用户ID	商户平台本地用户ID
amount	number	是	金额	订单金额
network	string	是	主网	主网(目前仅支持 TRON、BSC、POLYGON、ETHEREUM)
address	string	是	提款地址	提款地址
notifyUrl	string	否	回调地址	下单成功后，由 API 回调请求通知商户的地址 (回调详情参照文档3)
currency	string	是	币种	订单币种
userCurrency	string	是	用户实收币种	用户实收币种
successRedirectUrl	string	否	地址	成功后自动跳转地址
isBlockchain	boolean	否	是否返回区块链信息（默认false）	当为true时，回调请求会携带订单链上交易信息
expireSecond	Long	否	过期时间戳（秒）
sign	string	是	签名	详情见签名算法

请求 json 样例

{
  "key": "weOfDMRpUAvAeOs5",
  "localOrderId": "TestOTM0625ROB017",
  "notifyUrl": "http://www.baidu.com/728-TestOTM0625ROB01",
  "amount": 20,
  "network": "TRON",
  "currency": "CNY",
  "userCurrency": "USDT",
  "successRedirectUrl": "http://www.baidu.com",
  "address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
  "isBlockchain": true,
  "sign": "834e924f7846fe3a65b53e6680c8e53a"
}

响应 json 示例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
  
        "orderId": 473220978729221,
        "localUserId": null,
        "localOrderId": "TestOTM0625ROB017",
        "orderType": "WITHDRAW",
        "orderBizType": "WITHDRAW_ANY_DIGITAL_WALLET",
        "targetType": "EXTERNAL",
        "network": "TRON",
        "address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
        "currency": "CNY",
        "userCurrency": "USDT",
        "amount": "20",
        "userAmount": "2.994723",
        "userReceivableAmount": "2.994723",
        "rate": "6.67841204",
        "rateExpression": "1USDT≈6.6784CNY"
        }
}

响应data 参数说明

参数名称	类型	参数含义	备注
orderId	string	订单 ID
localUserId	string	商户本地用户 ID
localOrderId	string	商户本地订单号
orderType	enum	订单类型	`PAYMENT：支付订单 \| WITHDRAW：提款订单`
orderBizType	enum	订单业务类型	orderBizType 类型说明如下
targetType	enum	目标类型	targetType 类型说明如下
network	string	主网类型
address	string	地址	链上收款地址
currency	string	订单币种
userCurrency	string	到账币种
amount	string	订单金额
userAmount	string	用户实收金额
userReceivableAmount	string	用户应收金额
rate	string	汇率
rateExpression	string	汇率表达式

orderBizType 类型说明：

1、PAYMENT_WALLET_SCAN MINPAY钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至MINPAY钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付

targetType 类型说明：

1、INTERNAL 内部地址
2、EXTERNAL 外部地址
3、USER 用户抽象地址

回调返回 json 数据

默认所有回调参数参与验签，回调参数详情请看回调

回调 data

{
"amount":"20",
"bizType":"WITHDRAW_ANY_DIGITAL_WALLET",
"blockchain":{
               "network":"TRON",
               "receiverAddress":"TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
               "senderAddress":"TE35TrUfHjbGEBsVS6zVXdHS8HxXCWwC2y",
        "txId":"c5503ecf1f0979d5bc7a7e16c3cad20290449913ab47a7e18dfca6ba6f2725fa"
              },
"currency":"CNY",
"localOrderId":"TestOTM0625ROB017",
"merchantActualAmount":"57.32",
"merchantCurrency":"CNY",
"merchantId":302992856974,
"merchantPaidAmount":"20",
"notifyTime":1772259079786,
"orderCreateTime":1772259032870,
"orderId":"473220978729221",
"status":"SUCCESS",
"type":"WITHDRAW",
"userAmount":"2.994723",
"userCurrency":"USDT",
"userMinerFee":"0",
"userReceivableAmount":"2.994723",
"sign":"742e64d684648c32c7ad33cf8d5604e2",
"key":"9yUreYgTRtit39Dy"
}

当您收到回调通知后，请在处理完成后直接返回字符串 success，表示已成功接收并处理该消息。系统在收到 success 响应后，将不再对该笔回调进行重复发送。若未收到期望响应（未返回 success 或返回异常），系统将按照阶梯式重试机制重新发送回调通知，最多重试 14 次。当前重试时间间隔依次为： 15s, 15s, 30s,180s, 600s, 1200s, 1800s, 1800s, 1800s,3600s,10800s,10800s,21600s, 21600s

请求参数​

请求 json 样例​

响应data 参数说明​

orderBizType 类型说明：​

targetType 类型说明：​

回调返回 json 数据​

回调 data​